001    /**
002     * Java Gui Builder - A library to build GUIs using an XML file.
003     * Copyright 2002, 2003 (C) François Beausoleil
004     *
005     * This library is free software; you can redistribute it and/or
006     * modify it under the terms of the GNU Lesser General Public
007     * License as published by the Free Software Foundation; either
008     * version 2.1 of the License, or (at your option) any later version.
009     *
010     * This library is distributed in the hope that it will be useful,
011     * but WITHOUT ANY WARRANTY; without even the implied warranty of
012     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
013     * Lesser General Public License for more details.
014     *
015     * You should have received a copy of the GNU Lesser General Public
016     * License along with this library; if not, write to the Free Software
017     * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
018     */
019    
020    package jgb.builder;
021    
022    /**
023     * Abstract factory that returns {@link jgb.builder.TagHandler TagHandler}s
024     * based on the tag name.
025     * @since 0.1.1a
026     * @author Francois Beausoleil, <a href="mailto:fbos@users.sourceforge.net">fbos@users.sourceforge.net</a>
027     */
028    public interface TagHandlerFactory {
029        /**
030         * Returns a {@link jgb.builder.TagHandler TagHandler} for the
031         * named tag.
032         * This method must return the same instance each time it is called with
033         * the same argument.  This way, tag handlers can store information in their
034         * instance variables, although this is discouraged.
035         * @throws ClassNotFoundException If the named tag does not exist or is
036         * not understood by this factory.
037         */
038        TagHandler getHandlerFor(String tagName) throws ClassNotFoundException;
039    }